Release 10.1A: OpenEdge Data Management:
Database Administration

RFUTIL ROLL FORWARD qualifier

Reconstructs a database by applying to that database all notes stored in the AI file.

Syntax

rfutil db-name -C roll forward [ verbose ]       [    endtime yyyy:mm:dd:hh:mm:ss | endtrans transaction-number]       [ -B n ] [ -r ] -a ai-name

Parameters

db-name

Specifies the database you are using.

verbose

Produces information for every note in the AI area.

-a ai-name

Identifies the AI area of the specified database.

endtime

Specifies to roll forward to a certain time. You must specify the ending time as a string of digits and separate the date and time components with a colon. Transactions are included in the partial roll forward only if they end before the specified time. For example, to roll forward to 5:10 PM on July 18, 2002, type 2002:07:18:17:10:00. For RFUTIL to include a transaction in this partial roll forward, the transaction must have ended on or before 2002:07:18:17:09:59.

endtrans

Specifies to roll forward up to but not including the transaction beginning that contains the transaction-number. For example, if you specify endtrans 1000, RFUTIL rolls forward the AI area to transaction 999. If you want to include transaction 1000, you must specify endtrans 1001.

-B n

Specifies the number of database buffers. The single-user default value is 20.

-r

Indicates that buffered I/O will be used.

If the system crashes while you are running the ROLL FORWARD operation, restore your database files again and rerun the ROLL FORWARD operation.

The ROLL FORWARD qualifier displays the following information:

The start and end dates of the AI area being applied to the database.
The number of completed transactions reapplied to the database.
The number of transactions that were active after all AI notes were applied.

The ROLL FORWARD qualifier fails if:

You omit the After-image Filename (-a) parameter.
It cannot open the AI area.
You name the wrong AI area.
The database was opened before all AI extents were applied.

Notes

The ROLL FORWARD qualifier always disables after-imaging for the database before beginning the roll-forward operation. After the roll-forward has completed, you must re-enable it with the AIMAGE BEGIN qualifier if you want continued AI protection.
You must apply all AI extents associated with the database in the same sequence they were generated before you can use the database.